.. _ecmPtmCfg_AddItem_PT:

ecmPtmCfg_AddItem_PT
====================
--------------------


SYNOPSIS
--------


.. code-block:: none

  t_success  ecmPtmCfg_AddItem_PT(
    t_i32  NetID,
    t_i32  PtmMapIndex,
    t_f64  DurTime,
    t_f64  PosDataList[],
    t_i32  NumPosData,
    t_bool  IsAbsPos,
    t_i32  *ErrCode
  )



DESCRIPTION
-----------


- 이 함수는 PtmMapIndex로 지정된 PT-Motion 맵의 Hold 상태를 셋팅하는 함수입니다.



PARAMETER
---------


- NetID : Network 번호


- PtmMapIndex : 이송스텝을 등록하고자 하는 대상 PT-Motion 맵 인덱스.

- DurTime : 이송스텝의 지속시간(Duration Time)을 sec 단위로 설정합니다. 각 축은 이 값으로 지정된 시간 동안 PosDataList 배열에서 지정한 이송 거리를 이송하게 됩니다.

- PosDataList[] : 각 축이 이번 스텝에서 이송해야 하는 이송거리 또는 목표좌표값을 배열로 전달하는 매개변수입니다. ecmPtmCtl_Begin() 함수를 통해서 설정한 축의 수 만큼에 해당하는 위치데이터가 이 배열을 통해서 전달 되어야 합니다

- NumPosData : 배열을 통해서 전달되는 위치데이터가 실제로 몇 개인지를 지정합니다. 이 값이 ecmPtmCtl_Begin() 함수를 통해서 설정 한 축의 수와 다를 경우에는 에러로 처리됩니다.

- IsAbsPos : PosDataList 배열을 통해서 전달되는 위치데이터가 상대좌표(거리)인지 아니면 절대좌표(목표좌표)인지를 설정 합니다.

+-------+---------------------------------------------------+
| Value | Meaning                                           |
+=======+===================================================+
| 0     | PosDatList 배열의 위치 데이터가 상대 좌표 입니다. |
+-------+---------------------------------------------------+
| 1     | PosDatList 배열의 위치 데이터가 절대 좌표 입니다. |
+-------+---------------------------------------------------+


- ErrCode : 이 매개 변수를 통하여 현재의 에러 코드를 반환합니다. 단, 이 매개 변수에 NULL을 전달하면 에러 코드를 반환하지 않습니다.




RETURN VALUE
------------


- 이 리턴값은 불 형(Boolean Type) 을 가지고 있습니다.
 
+-------+--------------------------------------+
| Value | Meaning                              |
+=======+======================================+
| 0     | 함수 수행에 실패하였음을 의미합니다. |
+-------+--------------------------------------+
| 1     | 함수 수행에 성공하였음을 의미합니다. |
+-------+--------------------------------------+


.. seealso::
  :ref:`ecmPtmCtl_Begin EXAMPLE 참고  <ecmPtmCtl_Begin>`